LEGION Simulator Help

Maps Track Events

Events can be set up to save images of Maps (and also to clear Maps) at specified points along the Timeline. For a Map to be saved, it must be currently available and active in the Object Directory.

Adding a Save Map Event

This procedure allows saving all or selected active LEGION Maps at a specified time in the simulation.

To add a Save Map event:

  1. Right-click on the relevant Maps track at the time the event is to start and select “Add a Save Map event…”.
    • The Save Map dialog is displayed:
  2. If required, enter a name in the Event Name box.
  3. To run this event in the next recording session using the Timeline, leave the “Enable this event” box checked (or uncheck the box to ignore this event in the next recording session).
  4. Select one of the following option buttons:
    • Save selected Maps
    • Save all active Maps (if choosing this, proceed to step 6)
  5. Click the Select Maps button to select the Maps to be saved.
    • In the Select Objects dialog, pick the Maps to save using the selection buttons >, >>, <, << and click OK.
  6. From the Use Camera drop-down list, select the Camera to apply to the Map or Maps being saved (see the Cameras topic).
    • The default Camera Whole Model Camera is selected automatically when this event is first created.
  7. Set the Map image aspect ratio and dimensions:
    Note: The default aspect ratio is 16:9 and the default dimensions are 1920 x 1080 pixels.
    • Select an aspect ratio option from the Image Aspect Ratio drop-down.
    • To enter an aspect ratio that’s not listed, select the Custom option. The custom aspect ratio box appears.
    • Sizes and aspect ratio can be “linked” when using a custom aspect ratio.
      • When the sizes and aspect ratio are linked, changing one dimension automatically updates the other dimension such that the aspect ratio is always respected.
      • When the sizes and aspect ratio is are unlinked, they are independent and changing a dimension automatically updates the custom aspect ratio. The other image dimension is not changed.
      • To link or unlink sizes an aspect ratio, click the button between the X and Y size boxes:
    • The icon or button here indicates whether sizes and aspect-ratios are linked:
      • this icon (not a button) means sizes are linked to the aspect ratio and cannot be unlinked
      • this button means sizes and aspect ratio are linked, but they can be unlinked
      • this button means sizes and aspect ratio are not linked, but they can be linked
        Tip: Sizes are always automatically linked to preset (non-custom) aspect ratios. Only custom aspect ratios let you link or unlink sizes to the aspect ratio.
    • Set the preferred image size, remembering the above rules about linked/unlinked aspect ratios.
      • Only numbers can be entered.
      • Invalid values are highlighted by a red border around the input box.
  8. Select one of the three Image Format options:
    • JPEG
    • Bitmap
    • PNG – this is the default format
      Note: Default sizes and format are declared in the “Cameras, Images, Videos and Maps” tab of the Simulator Project Settings dialog. See the Camera, Image, Video and Map Defaults topic for details.
  9. To change the default Layout of the saved Map image, click the Layout button and make any changes to the Layout. See "Designing the Layout for Map Events" below.
  10. In the panel labelled Reuse these Map selection, Camera, Image dimensions, File format and/or Layout options in other Save Map events, select either:
    • Apply to all Maps – THIS track
    • Apply to all Maps – ALL tracks
      Tip: Making a selection here means you can apply these Save Map instructions to either all Maps on this track alone, or all Maps on all tracks on the active Timeline.
    • A selection dialog appears:
    • Click on the items to reuse; hold <CTRL> while clicking to select multiple items.
    • Click the OK button. Settings of the selected items are applied to all Maps tracks in the active Timeline. Selections are remembered and items are automatically selected again the next time this dialog appears.
  11. Click OK to save the event.
    • If the event overlaps other events, an error message is displayed. See Overlapping Events.

To change the start and end times of a Save Map event, follow the procedure described in Changing the start and end times of a Changing the start and end times of a Record .RES event.

Adding a Clear Map Event

This event will clear (reset) a generated Map at a specified point within the simulation. This is useful for isolating Maps for peak periods within a simulation or, for instance, to clear accumulated data between the arrival of trains.

To add a Clear Map event:

  1. Right-click on the relevant Maps track at the when the event is to start and select Add a Clear Map event.
    • The Clear Maps dialog is displayed.
  2. If required, enter a name in the Event name box.
  3. To run this event next time the simulation is played back, leave the Enable this event box checked (or uncheck the box to ignore this event in the next session).
  4. To clear specific Maps, select Clear selected Maps, click the Select Maps… button, then select the Map(s) to clear.
    • Clear all active Maps – this will clear all active Maps.
  5. Click OK to save the event.
  6. If the event overlaps other events, an error message is displayed. See Overlapping Events.

Designing the Layout for Map Events

The Layout Designer is for adding and arranging visual elements to saved Map images. When working with only one Map, the saved results will match the designed Layout. When saving more than one Map, the Layout here works more as a general template and saved results should always be checked before including in a report.

To design the Layout for Map Events:

  1. From the Save Map dialog, click the Layout button.
    • The Layout Designer dialog is displayed.
  2. To add any of the customisable items in the Video Components toolbar, click and hold the relevant icon and drag into the Layout Designer. Position and resize the items according to preference.
  3. To change the properties of a label, clock, logo, or legend, click on the item to select it and change the properties in the left-hand panel of the dialog box. Change properties in the Value column by entering text directly, browsing for files or selecting values from drop-down lists.
    • – Label: Insert text Label into the Layout
      • change font, text colour, contour line values, background colours
    • – Clock: Add a simulation clock display to the Layout
      • change time format, font, text colour, contour line values, background colours
    • – Logo: Browse to select an alternative logo image
      • change logo colour, contour line values, background colour, transparency
    • – Legend: Adds a legend for the Map being recorded by this event
      • Legend – depending on which maps were selected for this event, and how many legends they have, choose All or specific legends from this drop-down list
      • Title – enter a Title; choose Text Colour and Font
      • Units – enter Units; choose Text Colour and Font
      • Labels – choose Text Colour and Font
      • Contour – select “yes” or “no” to show or hide contour lines; choose Contour Line Colour
      • Background – choose a Background colour and add a value for Background Transparency (0 is opaque)
    • – Graph: Select a graph from the drop-down list labelled Value in the Graph Name row.
  4. To change the background colour of the workspace, select a colour from the drop-down palette labelled Background Colour.
  5. Components can be aligned in relation to each other; see Aligning AVI Components for details.
    • – Align left: Select at least two items and click to align their left sides.
    • – Align right: Select at least two items and click to align their right sides.
    • – Align top: Select at least two items and click to align their top sides.
    • – Align bottom: Select at least two items and click to align their bottom sides.
    • – Equal widths: Select at least two items and click to make them the same width.
    • – Equal heights: Select at least two items and click to make them the same height.
    • – Centre horizontally: Select one or more items and click to centre them horizontally (vertical positions will be unchanged).
  6. To delete a removable item, click it to select it and press Delete.
  7. Click OK to save the new Layout settings.